==SAINTS PATROL v1.2b==
-------------------------------------------------------------------------------------------------

Are you tired of setting up vehicles in Gang Customization categories only to never see them parked in the streets or being driven around by your gang anywhere? If you answered yes, read on. If you answered fuck yes, then this mod will be your wet dream. The idea for this mod started out as a simple way for me to tackle an annoying bug present since Saints Row The Third classic - your gang spawns on foot in 100% controlled districts which is an apt reward for taking the entire hood over but they don't drive around in Saints gang vehicles, specifically the ones you select in Gang Customization options. If you haven't noticed, they do spawn driving cars sometimes but these are civilian versions of the cars you choose in your Gang Customization options. I won't bore you with the details but suffice it to say, the issue is in a flag in one of the game files that disregards specified variants and I could fix it if we had better modding tools available.

Since we regrettably do not have better modding tools to pry open the files we need, I've resorted to a brute force method. On an unrelated note - do you like buses in this game? Me neither. So I replaced them with Saints vehicles. As it happens, we need people driving these vehicles. So I designated a few drivers too - our beloved gang, of course. Be warned that since this is a brute force method, your gang customization choices will not matter; only the choices I have provided through installation files would. Your game, otherwise, will function normally and whatever your gang customization does affect (including the odd civilian vehicle being commandeered by your chosen gang members) will remain untouched. There is now also an option to have your Saints Backup (that you call in via phone) drive up to you in the Saints N-Forcer!

As of the latest update, you have the following choices available in the mod:

- Tactical module
   - SNG homies patrolling in Saints N-Forcers
   - SWAT homies patrolling in Saints N-Forcers
   - SNG/SWAT homies patrolling in Saints N-Forcers
- Vanilla module
   - All 8 different Saints homies patrolling in 8 different Saints vehicles: Saints Enforcer, Saints Hammer, Saints Atlantica, Saints Bootlegger, Saints Sovereign, Saints Criminal, Saints Infuego, Saints Torch and Saints Reaper
- Custom module
   - My personal configuration which is the same as vanilla module plus Stripper Saints and a female Biker Saint driving Saints vehicles described in the Vanilla module
- Better despawning if you're fed up of vehicles and NPCs disappearing the moment they're out of your FOV
- Optional file allowing your Saints Backup that you call in via phone to arrive in Saints N-Forcer

IMPORTANT: You do NOT need to have unlocked the gang members featured by this mod or have them selected in the gang customization screen for this mod to function. The mod will spawn them irrespective of who you have selected in the gang customization screen. This also means that you cannot change which gang members will spawn driving these vehicles around from inside the gang customization screen; you can only do that through the provided options at the time of installation.

IMPORTANT 2: If you choose to install the N-Forcer appearing as Saints Backup (as called from the phone), your gang as you have it set up in gang customization would drive up in it; NOT the gang members from this mod because that's how the game handles that. So for example, if you want to see only SWAT and SNG guys on the streets, driving around in N-Forcers AND when you call for backup, set your gang members in the gang customization screen to SNG and SWAT only. Alternatively, if you want more variety in the gameworld, select anything other than the gang members you have installed via this mod, in your Gang Customization options. 

IMPORTANT 3: If you choose to install the Tactical module, you will not have Saints N-Forcers parked in the streets and parking lots. Game engine limitations - nothing I can do about that.

IMPORTANT 4: If you installed Vanilla or Custom modules, be aware that Saints vehicles will still spawn parked throughout the world even if you haven't taken the district over. If this ruins immersion for you, you may want to delay installing the mod until you've taken over enough districts where you're comfortable with Saints vehicles spawning parked everywhere.

Known Bugs:

Since the mod is in beta, bugs are to be expected. Current known bugs are as follows:

- If you choose to install the optional "N-Forcer as your Saints Backup vehicle" feature, one Saints member will arrive on foot since it summons 4 Saints, even though an N-Forcer only seats 3. Its just optics since they spawn nearby anyway, nothing game or even immersion-breaking. I could fix it by limiting it to 3 Saints only but I figured why lose out on an extra Saint just for something that doesn't even matter that much. There's already a cooldown on Saints Backup so you get limited reinforcements as it is. I can fix it if there's enough demand for it though.

INSTALLATION:

- Unzip the content files.

- Copy and paste the following files into your root installation directory:
  custgangcategories.xtbl
  gang_names.xtbl
  spawn_info_categories.xtbl

- Next, choose ONLY ONE desired flavor from either "Tactical - SNG SWAT + Saints N-Forcer" (this has multiple choices, choose ONE) or "Vanilla - Saints + Saints vehicles".

- Copy and paste the contents from your chosen folder into your root installation directory.

- If you choose to install anything from the "Optional" folder, copy and paste those files in your root installation directory.

UNINSTALLATION:

- Delete the following 5 files from your root installation directory:
1. character.xtbl
2. custgangcategories.xtbl
3. gang_names.xtbl
4. spawn_info_categories.xtbl
5. spawn_info_groups.xtbl

- If you installed Better Despawn optional files, delete the following 2 files as well:
1. distant_ped_spawn_parameters.xtbl
2. distant_vehicle_spawn_parameters.xtbl

- If you installed Vanilla or Custom module, delete the following 6 files as well:
1. car_4dr_luxury06.xtbl
2. car_4dr_luxury06_veh.xtbl
3. car_4dr_muscle01.xtbl
4. car_4dr_muscle01_veh.xtbl
5. sp_hearse01.xtbl
6. sp_hearse01_veh.xtbl

- If you installed N-Forcer Saints Backup file, delete the "homies.xtbl" file as well

NOTE:

- If you have other mods that modify the same files as the ones that my mod does, you may have to use Winmerge to manually identify and merge the two mods on your own. Do not attempt to do this unless you know what you're doing.